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PREFACE 



This publication is intended for system 
programmers and IBM Field Engineering 
personnel. The reader should be famil- 
iar Mith the general machine functions 
of 370-XA, as described in the IBM 
570-XA Pri nci pies of Operati on ? 
SA22-7085, and with the MVS/SP Version 2 
Licensed Program* referred to in this 
publication as the MVS/XA control 
program. The standard names for MVS/XA 
control blocks are used throughout the 
publication. The formats of these 
control blocks are described in the 
MVS/XA Debuqqi ng Handbook* Volumes 1 
through 5, LC28-1164 through LC28-1168, 
respectively. 
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Changes are periodically made to the information herein; before 
using this publication in connection with the operation of IBM 
equipment* refer to the latest IBM Sv5tem/370 and 4300 Processors 
Bi bli oqraphv * GC20-0001* for the editions that are applicable and 
current. 

References in this publication to IBM products* programs, or 
services do not imply that IBM intends to make these available in 
all countries in which IBM operates. Any reference to an IBM 
program product in this publication is not intended to state or 
imply that only IBM's program product may be used. Any func- 
tionally equivalent program may be used instead. 

Publications are not stocked at the address given below. 
Requests for IBM publications should be made to your IBM repre- 
sentative or to the IBM branch office serving your locality. 

A form for reader's comments is provided at the back of this 
publication. If the form has been removed* comments may be 
addressed to IBM Corporation* Product Publications, Department 
B98* PO Box 390* Poughkeepsi e* NY* U.S.A. 12602. IBM may use or 
distribute any of the information you supply in any way it 
believes appropriate without incurring any obligation whatever. 
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ASSISTS FOR MVS/XA 



This publication describes six 
instructions that depend on control 
blocks whose formats and relationships 
normally are established only by the 
MVS/XA control program. These 
instructions improve performance in 
frequently used parts^^f the MVS/XA 
control program on machines which 
provide the 370-XA architectural mode 
and these instructions. Four of the 
instructions assist the handling of 
control-program locks. A locking proto- 
col is used by the MVS/XA control 
program to achieve serial use of 
control-program resources! when multipro- 
gramming and multiprocessing activities 
may cause temporary^ multiple demands 
for the same resource. One instruction 
assists the execution of the SUPERVISOR 
CALL instruction, which is frequently 
used to request control-program 
services. The remaining instruction 
helps in establishing parameters that 
are used by the MVS/XA control program 
following detection of certain failure 
and error conditions. The six 
instructions are: 

ADD FRR 

OBTAIN CMS LOCK 
OBTAIN LOCAL LOCK 
RELEASE CMS LOCK 
RELEASE LOCAL LOCK 
SVC ASSIST 

All of the instructions srs privileged 
i nstructi ons. 

ADD FRR uses the RRE instruction format: 



Op Code 
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The other instructions use the SSE 
format. The SSE instruction format is: 
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protection applies to all storage opei — 
and accesses in the usual way. A 
specification exception is recognized 
for any operand that does not meet a 
specified alignment requirement, and 
instruction execution is suppressed. 
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Program-event recording applies in the 
usual fashion to these i nstructi ons^ 
except that branch events are not recog- 
nized when these instructions cause 
branchi ng. 

The two instructions which obtain locks 
fetch and test a word for zeros, and, if 
the fetched word is zero, cause a speci- 
fied value to be stored back at the same 
location by means of an interlocked 
update. The two instructions which 
release locks may perform a conditional 
interlocked update of a doubleword 
location. For these instructions, if 
the second word of a doubleword location 
contains all zeros, the entire double- 
word is set to zeros by means of an 
interlocked update. When the SVC ASSIST 
instruction is used to assist a type-1 
SVC, a conditional interlocked update of 
a doubleword location is performed which 
is similar to that performed by the 
COMPARE DOUBLE AND SWAP instruction. 

The four lock-handling instructions may, 
under certain conditions, access the 
lock-i nterface-tabie prefix, consisting 
of the four words at negative offsets 
from the lock-interface table. The 
lock-interface table is located by using 
an address contained in the word in main 
storage following the second operand. 



SIMPLIFIED EXECUTION PATHS 



Simplified execution paths are defined 
for the following instructions. When a 
simplified path is used, specific 
actions defined for the corresponding 
instruction are performed uncondi- 
tionally; that is, specific actions are 
taken without the prescribed tests being 
made to determine that those actions 
should be selected. 



OBTAIN CMS 
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OBTAIN LOCAL LOCK . Execution 
proceeds as if the local lock were 
already held. 

• RELEASE CMS LOCK . Execution 
proceeds as if the currently 
dispatched unit of work held no CMS 
lock. 

RELEASE LOCAL LOCK . Execution 
proceeds as if the local lock were 
already released. 

• SVC ASSIST . Instruction execution 
is completed with normal instruc- 
tion sequencing and without the 
performance of other actions. 

Use of the simplified execution paths is 
not apparent to application programs 



using program products. In certain 
models^ simplified execution paths are 
used when the available control-storage 
space is limited. The ADD FRR instruc- 
tion is optional and may or may not be 
provided as part of the assists. 



INSTRUCTIONS 



The instructions described in this 
section are listed in the figure 
"Instruction Summary*" as are their 
operation codes and the program- 
interruption conditions that can be 
recognized when they are executed. 

In the format shown in the instruction 
description, the operation code is given 
in hex, which is signified by enclosing 
its value in single quotation marks 
(»XXXX»). 
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Code 



ADD FRR 

OBTAIN CMS LOCK 
OBTAIN LOCAL LOCK 
RELEASE CMS LOCK 
RELEASE LOCAL LOCK 
SVC ASSIST 



RRE 


M 


A 


SP 


R 


SSE 


M 


A 


SP 


R 


SSE 


M 


A 


SP 


R 


SSE 


M 


A 


SP 


R 


SSE 


M 


A 


SP 


R 


SSE 


M 


A 


SP 


R 



OP 



ST 


B242 


ST 


E506 


ST 


E504 


ST 


E507 


ST 


E505 


ST 


E503 



Explanati on : 



A Access exceptions 

M Privileged-operation exception 

OP Operation exception 

R PER general-regi stei — alteration event 

RRE RRE instruction format 

SP Specification exception 

SSE SSE instruction format 

ST PER storage-alteration event 
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ADD FRR 



OBTAIN CMS LOCK 
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A new entry is added to the top of the 
current functi onal-recovery-routi ne 
(FRR) stack. The entry is initialized 
with values provided in general regis- 
ters, with the PSW A-mode bit (bit 32), 
and with the PSW S bit (bit 16). 
Optionally, the contents of control 
registers 3 and 4 are saved in an entry 
in a separate table. 

The general register designated by the 
R2 field provides the logical address of 
the FRR entry point. 
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Logical location 380 hex contains the 
logical address of the stack-table head- 
er. The stack-table header contains 
(1) a logical address which is 32 less 
than the address of the first dynamic 
entry in the stack table, (2) the 
logical address of the last entry in the 
stack table, and (3) the logical address 
of the current stack-table entry. 
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code remains 



Condi t i on Code: The 
unchanged. 

Program Except i ons: 



Access (storage operands) 
Operation (when the instruction is 
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Privileged operation 
Speci f i cati on 
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Forms Used i n the Control Program 
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Otherwise, the updated instruction 
address is placed in general register 
12, with a zero placed in bit position 
0; the contents of the word at LIT minus 
8 are placed in general register 13, and 
bits are selected from the word which 
replace the instruction-address portion 
of the PSW, leaving the A-mode bit 
unchanged. 

Serialization occurs before the lock is 
fetched and, if the lock is obtained, 
again after the lock is updated. 
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Form Used j_n the Control Program 
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If the local lock in the ASCB addressed 
by the first-operand word is not held^ 
the lock is replaced> by using an intei — 
locked update^ with the value from the 
word at the second-operand location 
minus 4; the local-lock bit of the word 
fetched from the second-operand location 
is set to one; and zeros are placed in 
general register 13, 

Otherwise, the updated instruction 
address is placed in general register 
12» with a zero placed in bit position 
0; the contents of the word at LIT minus 
16 are placed in general register 13, 
and bits are selected from the word 
which replace the instruction-address 
portion of the PSW, leaving the A-mode 
bit unchanged. 

Serialization occurs before the local 
lock is fetched and, if the lock is 
obtained, again after the lock is 
updated. 



after the CMS lockword is zero, then the 
doubleword containing the lockword is 
set to zero by using an interlocked 
update. Also, the word fetched from the 
second-operand location is set to show 
that no CMS lock i s held, and zeros are 
placed in general register 13. 

Otherwise, the updated instruction 
address is placed in general register 
12, with a zero placed in bit position 
0; the contents of the word at LIT minus 
4 are placed in general register 13; and 
bits are selected from the word which 
replace the instruction-address portion 
of the PSW, leaving the A-mode bit 
unchanged. 
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Form Used i n the Control Program 
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If (1) the contents of the CMS lockword 
addressed by general register 11 equal 
the contents of the first-operand word, 
(2) the currently dispatched unit of 
work holds a CMS lock, and (3) the word 
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Otherwise, the updated instruction 
address is placed in general register 
12, with a zero placed in bit position 
0; the contents of the word at LIT minus 
12 are placed in general register 13, 
and bits are selected from the word 
which replace the instruction-address 
portion of the PSW, leaving the A-mode 
bit unchanged. 
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The first and second operands are words 
containing the addresses oi 
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ASCB and TCB, respectively. 

Main-storage locations which contain 
status for the last SVC interruption are 
tested to determine if SVC-assi st action 
is to be taken. If SVC-assi st action is 
not taken, instruction execution is 
completed with normal instruction 
sequencing. No assist action is taken 
unless the CPU was enabled prior to the 
last SVC i nterrupt i on> and a task is 
currently dispatched which holds no 
locks and for which SVC screening is not 
activated. In addition, no assist 
action is taken unless (1) both the 
primary space and the secondary space 
match the dispatched space, and 
(2) primary-space mode is specified in 
the supervisoi — call old PSW. 

A type-1 SVC request is assisted only if 
the request is for an assi stable type-1 
function, if the only lock needed for 
the requested SVC function is the local 
lock, and if an attempt to obtain the 
local lock is successful. 

A type-2, -3, or -4 SVC request is 
assisted only if the request is for an 
assistable function of type 2, 3, or 4, 
and if an attempt to dequeue an SVRB 
from the SVRB pool of the current 
address space is successful. 



A type-6 SVC request is assisted only if 
the request is for an assistable type-6 
function for which no locks are needed. 

Assist action consists in copying the 
iaforma±ion stored at tke^ last SVC 
interruption into the current request 
block, saving all 16 general registers, 
loading the general registers as shown 
below, and then loading the instruction 
address portion of the PSW from general 
regi ster 9 . 
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Contents Loaded 
on Assi st Acti on 

Address of CVT 

Second operand 

Address of the current RB for 
type 1 or type 6; address of 
the acquired SVRB for type 2, 
3, or 4 

SVC entry-point address 

First operand 

Address of the RB for the 
program which was being 
executed at SVC interruption 

Entry address from that MPL 
field which is appropriate to 
the SVC type, that is, the 
address of the routine that 
receives control on completion 
of the assi st 

Address of the MBCB part of 
the SVRB acquired; for type 2, 
3, or 4 only 

Address of requested SVC-table 
entry 

Exit address from that flPL 
field which is appropriate to 
the SVC type 
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